package top.ruanlitao.shortlink.project.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import top.ruanlitao.shortlink.project.dao.entity.ShortLinkDO;
import top.ruanlitao.shortlink.project.dto.req.RecycleBinRecoverReqDTO;
import top.ruanlitao.shortlink.project.dto.req.RecycleBinRemoveReqDTO;
import top.ruanlitao.shortlink.project.dto.req.RecycleBinSaveReqDTO;
import top.ruanlitao.shortlink.project.dto.req.ShortLinkRecycleBinPageReqDTO;
import top.ruanlitao.shortlink.project.dto.resp.ShortLinkPageRespDTO;

/**
 * 回收站接口层
 */
public interface RecycleBinService extends IService<ShortLinkDO> {

    /**
     * 保存链接至回收站
     *
     * @param requestParam 请求参数
     */
    void saveRecycleBin(RecycleBinSaveReqDTO requestParam);

    /**
     * 按照 gid 列表分组查询短连接列表
     *
     * @param requestParam 分组查询短链接请求请求参数
     * @return 短链接分组响应参数列表
     */
    IPage<ShortLinkPageRespDTO> pageRecycleBinShortLink(ShortLinkRecycleBinPageReqDTO requestParam);

    /**
     * 将短链接从回收站恢复
     * @param requestParam 回收站恢复请求参数
     */
    void recoverRecycleBin(RecycleBinRecoverReqDTO requestParam);

    /**
     * 从回收站将短链接永久删除（不可逆）
     * @param requestParam 删除短链接请求参数
     */
    void removeRecycleBin(RecycleBinRemoveReqDTO requestParam);
}
